home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / mac / raytrace / dkb / dump2pct / dump2pct.hqx / Dump2PICT / Dump2PICT.doc next >
Encoding:
Text File  |  1991-07-14  |  3.7 KB  |  76 lines
  1. * Dump2PICT 1.0.1
  2.  
  3. Was written in MPW Pascal 3.0. It is hereby released to the public domain.
  4. Sources are provided, along with the executable, in the this archive.
  5.  
  6. * What does it do?
  7.  
  8. Dump2PICT converts files from Dump/QRT format, as used by DKBTrace, to and from
  9. Macintosh PICT format. Such conversions are necessary, because none of the
  10. output formats that DKBTrace can produce, are commonly supported on the
  11. Macintosh, so you would have trouble viewing your images without it.
  12. Also, if you want to use DKBTrace's image-mapping capability, you need to
  13. supply it with GIF, IFF or Dump images, rather than PICT.
  14.  
  15. * Dump -> PICT
  16.  
  17. This is probably the most important conversion, as you need it to view your
  18. output files without image-manipulation software like Adobe Photoshop.
  19. You select "Dump -> PICT..." from the "File" menu. You will be presented with
  20. the familiar Standard File dialogs to select the file to be converted, and to
  21. name the destination file.
  22. The PICT file that is produced contains a 24-bit-per-pixel pixmap. This can be
  23. quite big, though the PICT file will usually be smaller than the original Dump
  24. file. The good news is that no information is lost in this conversion, so feel
  25. free to throw away that bulky Dump file!
  26.  
  27. * PICT -> Dump
  28.  
  29. If you have PICT files lying around that you want to use as image maps in a
  30. scene description, you will need to convert them to a format DKBTrace can read.
  31. Since I was too lazy to add a PICT file reader to DKBTrace, you will have to
  32. convert your PICT files to Dump, GIF or IFF format. IFF support is hard to find
  33. on the Macintosh, and GIF files have the disadvantage of losing colour
  34. information. Dump files are true-colour files (24 bits per pixel), so you
  35. really should use Dump2PICT to convert your files to Dump format.
  36. The conversion works just like the Dump -> PICT conversion, using the same
  37. polished user interface.
  38.  
  39. * Customizing the PICT file creator
  40.  
  41. The file creator of PICT files created by Dump2PICT is usually '8BIM', so they
  42. will be opened by Adobe Photoshop when double-clicked. To change this setting,
  43. you must change the 'crea' resource in Dump2PICT with ResEdit. To find out what
  44. to change it to, select "Get File/Folder Info..." in ResEdit, and select the
  45. graphics application of your choice. Select the contents of the "Creator" field
  46. and copy it to Dump2PICT's 'crea' resource.
  47.  
  48. * How come the partition size is only 64K?
  49.  
  50. Dump2PICT does need a lot of memory to store the image being converted - 32
  51. bits per pixel, in fact. However, if MultiFinder if running - or if you are
  52. using System 7.0 or later - the off-screen pixel map is not allocated in the
  53. application's partition, but in the System's memory pool.
  54. Note that this will fail if you fill memory completely by launching too many
  55. applications. You should leave something like 1 megabyte free. By the way, this
  56. is a good idea generally, since many programs try to satisfy their temporary
  57. memory requirements this way.
  58. Obviously, your Mac's memory is used more effectively this way than if you had
  59. to increase each application's partition to accomodate its worst-case memory
  60. requirement.
  61. So, if Dump2PICT fails and you suspect a memory problem, do not increase its
  62. partition size, but just quit from another application and try again. Under
  63. UniFinder, you do not need to worry about any of this, as Dump2PICT gets all
  64. memory anyway.
  65.  
  66. * System requirements
  67.  
  68. Dump2PICT needs System 6.0.5 or later, with 32-Bit QuickDraw. Should be no
  69. problem, since the requirements for running DKBTrace are even worse.
  70.  
  71. * Changes from 1.0
  72.  
  73. Fixed problem that caused PICT -> Dump conversion not to work properly under
  74. System 7.0. Also added code to clear the off-screen pixmap before loading the
  75. Dump or PICT file into it, preventing garbage from appearing in some cases.
  76.